home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Cream of the Crop 22
/
Cream of the Crop 22.iso
/
comm
/
eumal610.zip
/
EUMAIL.DOC
< prev
next >
Wrap
Text File
|
1996-10-27
|
29KB
|
597 lines
EUMAIL.DOC 1 Revised: 10-27-96
The EUMAIL.EXE program does some summarizing for the Eudora Internet e-mail
program.
What is Eudora? Eudora is an excellent Internet e-mail program. It's put out
by QUALCOMM Incorporated in San Diego California. The latest version of Eudora
Light can be found on ftp.qualcomm.com, in the directory
quest/windows/eudora/1.5. The Windows freeware user manual can also be found on
ftp.qualcomm.com, in the directory quest/windows/eudora/documentation.
EUMAIL, on the other hand, is a freeware utility which reads Eudora's files and
provides the following benefits:
* Allows you to save your Eudora nickname file (containing individuals and
groups with the corresponding e-mail addresses) as a DOS text file which
is useful for searching and such. (Have you ever tried to find out where
all you have someone's e-mail address referenced in your nickname file?)
* Presents a summary of how many messages you have in each of your mail
folders, including their date range and their total size in bytes, plus
what share of total mailbox bytes this particular folder accounts for.
* Allows you to dump all (or a subset of your mailboxes) as straight ASCII-
text files. There will be one text file per mailbox, prefaced by a table
of contents for all messages in that mailbox.
* Allows you to write out just the table of contents as an ASCII text file.
* Allows you to write each individual message as an incremented file name
(TRASH.001, TRASH.002, etc).
* Allows you to process all mailboxes or all mailboxes whose names begin
with a certain string.
* The date format shown is based on your country setting as detected by
DOS.
NOTE ABOUT "INVALID FUNCTION CALL" ERROR MESSAGES:
If are using the /SHOWEXT setting, you may encounter errors in using this
program. The main reason for this is either (a) you've changed your default
date format since you started receiving mail using Eudora or (b) your Windows
country setting (which is what Eudora uses) is different from what your DOS
setting (which is what EUMAIL uses) is. If either of these are the case, you
will probably get "invalid function call" errors. See the section on "Country
Notes" at the end of this documentation for information on how to set the
value in your CONFIG.SYS file.
EUMAIL.DOC 2 Revised: 10-27-96
The e-mail data base:
EUMAIL creates a dump of your e-mail data base. This includes all of your
nicknames and comments (the use of comments is heavily recommended). This is an
ideal file to use the DOS FIND command (or the Wayne Software BFIND command) to
search through. A sample of the format:
BanBruce : Bruce Guthrie <bguthrie@doc.gov>
BanForrest : Forrest Williams <fwilliams@doc.gov>
BanJoe : Joe Correia jcorreia@doc.gov
BanTravis : Travis Mayo <tmayo@doc.gov>
WS_READ : Billy Rudock <billy_rudock@notes.seagate.com>
[2]: Les Ferch <ferch@cce.ubc.ca>
[3]: Martin Mossakowski <mossako@asterix.uni-muenster.de>
[4]: Tony Vincent <tonyvinc@iconz.co.nz>
XList > requests: majordomo@chaos.taylored.com
XList > msg: SUBSCRIBE X-FILES
XList > msg: SUBSCRIBE X-FILES-DIGEST
XList > msg: UNSUBSCRIBE X-FILES
XList : x-files@chaos.taylored.com
The fields in the file are:
* The nickname you've defined for this user
* The actual name (if any) of that user
* The e-mail address for that user
Comments are indicated with ">" entries and they appear before the actual entry.
Nicknames which define multiple users are sorted by actual name and then by
e-mail address. Typically, as is shown above, only the first instance of the
nickname is shown with all of the individual contacts shown with item counts.
Alternatively, you can use the /REPEAT option and the nickname label will repeat
for each item. The latter option is useful when you are using the FIND or BFIND
command to searchfor all members of a particular group.
EUMAIL.DOC 3 Revised: 10-27-96
The summary of your Eudora mailboxes and folders:
EUMAIL creates a summary of all the mailboxes and folders you've created. These
show the number of messages, the date range, and file size, and what percent of
total bytes consumed each box accounts for. A fairly complete dump of what mine
looked like when I ran it:
C:\TEMP\PHONMAIL.OUT generated 10-18-1996 00:54:08 by EUMAIL.EXE
Box/folder name msgs % of earliest -> newest bytes % of
msgs bytes
In 34 1% 05-21-96 -> 10-16-96 324,042 2%
Trash 346 9% 11-15-94 -> 10-17-96 1,156,646 7%
Out 256 6% 10-14-96 -> 10-16-96 463,945 3%
... (portion deleted to make it fit on the page) ...
Wayne 187 5% 04-07-96 -> 10-16-96 426,159 3%
X-Files 28 1% 04-07-96 -> 10-16-96 130,698 1%
Humans
Arlene 343 9% 08-12-96 -> 10-16-96 1,157,929 7%
Family 46 1% 01-19-96 -> 10-07-96 67,100 0%
Munchkyn 29 1% 12-15-95 -> 10-15-96 47,420 0%
Webman 50 1% 02-02-96 -> 10-15-96 99,420 1%
4 boxes 468 12% 12-15-95 -> 10-16-96 1,371,869 9%
Humor
__Progress 139 3% 04-28-96 -> 10-15-96 381,048 2%
_Cartoons 67 2% 04-28-96 -> 10-05-96 437,440 3%
_Comedians 64 2% 05-01-96 -> 10-08-96 357,953 2%
_Computers 63 2% 02-06-96 -> 09-29-96 243,605 2%
_Lists 218 5% 04-15-96 -> 10-08-96 516,521 3%
_Misc 266 7% 02-06-96 -> 10-11-96 869,856 6%
_Songs/Lyrics 6 0% 05-11-96 -> 08-13-96 15,852 0%
_TV/Movies 7 0% 05-20-96 -> 10-05-96 54,606 0%
8 boxes 830 21% 02-06-96 -> 10-15-96 2,876,881 18%
Keep
1993 3 0% 10-22-93 -> 10-24-93 7,907 0%
1994 3 0% 05-18-94 -> 12-11-94 20,506 0%
1995 27 1% 01-05-95 -> 12-29-95 78,193 1%
1996 85 2% 01-02-96 -> 02-28-96 226,929 1%
0_Hold 87 2% 10-28-95 -> 09-16-96 193,348 1%
5 boxes 205 5% 10-22-93 -> 09-16-96 526,883 3%
Misc
Misc 19 0% 03-16-96 -> 10-10-96 46,542 0%
NMAA 6 0% 09-28-95 -> 09-28-96 23,172 0%
Resends 41 1% 09-01-96 -> 10-01-96 10,378 0%
Websites 16 0% 02-20-96 -> 07-19-96 33,831 0%
Work 1 0% 04-08-96 -> 04-08-96 10,867 0%
5 boxes 83 2% 09-28-95 -> 10-10-96 124,790 1%
Out_Prev
Wk39 380 9% 09-23-96 -> 09-29-96 1,168,188 7%
Wk40 384 10% 09-30-96 -> 10-06-96 810,029 5%
Wk41 244 6% 10-07-96 -> 10-13-96 505,446 3%
3 boxes 1,008 25% 09-23-96 -> 10-13-96 2,483,663 16%
37 boxes 4,023 100% 11-15-94 -> 10-17-96 15,588,849 100%
EUMAIL.DOC 4 Revised: 10-27-96
The program, by default, will automatically display information about "large"
boxes based on a combination of three criteria. Lines above will be shown
on-screen for any box which exceeds any of the three criteria. The three are:
* The total number of messages in the box (/n parameter)
* The total number of (thousand) bytes in the box (/nK parameter)
* The percentage of total bytes that that box accounts for (/n% parameter)
The defaults are /100, /100K, and /5%.
If you'd like to turn off the on-screen display entirely, you can specify the /Q
parameter. If you'd like the criteria to be based on one or two criteria only,
specify an unusually large value for the other parameter(s) (e.g. /30000K).
Using an INI file for the criteria (see later) is always an option.
Header formats:
When you request either /DUMP or /HEADERS, the program will generate headers
which describe what messages are in your file. The order of the messages
corresponds to the order shown in Eudora. The exact format of the headers
depends on your value for the /FORMAT=n parameter. The various formats are:
/FORMAT=1: Show one line per mail message. This format closely matches that
shown in Eudora itself. This is initially the default for EUMAIL. /FORMAT=2:
Show two or more lines per message. The subject gets a line
all to itself. You may get three lines for some messages if the
length of the "Sender" field is long. /FORMAT=3: Show one line per mail
message. This format shows just the message
size and subject line; this is useful when you're using Eudora to
catalog messages and such and don't really care when they were
sent or from whom.
Examples of each format are shown below:
Contents: (using /FORMAT=1)
1 Bruce Guthrie 04:31 PM 3/26/96 2 Round robin time
2 Bruce Guthrie 11:44 AM 4/7/96 1 RE: FORB data update
3 Olumoya - Pamela 07:49 PM 4/7/96 14 Posting Guidelines for X-Files-Fanfic
(fwd)
4 Heather and Eric 07:29 PM 4/19/96 4 re: Vancouver locations for x-filese
Contents: (using /FORMAT=2)
1 Bruce Guthrie 04:31 PM 3/26/96 2K
Round robin time
2 Bruce Guthrie 11:44 AM 4/7/96 1K
RE: FORB data update
3 Olumoya - Pamela 07:49 PM 4/7/96 14K
Posting Guidelines for X-Files-Fanfic (fwd)
4 Heather and Eric 07:29 PM 4/19/96 4K
re: Vancouver locations for x-filese
EUMAIL.DOC 5 Revised: 10-27-96
Contents: (using /FORMAT=3)
1 2K Round robin time
2 1K RE: FORB data update
3 14K Posting Guidelines for X-Files-Fanfic (fwd)
4 4K re: Vancouver locations for x-filese
ASCII dumps:
The EUMAIL program will dump the contents of all of your e-mail boxes for you if
you'd like. (Optionally, you can specify that it only dump mailboxes whose
names begin with a certain character string.) In so doing, it creates a table of
contents and divided each article with a page eject for you. The format for
this table of contents is discussed above.
The ASCII message dump is requested with the /DUMP parameter. A separate dump
file (with an extension of *.DMP) will be created for each mailbox.
Alternatively, you can request that a separate text file be created for each
message, in which case the file extensions will have incremented names (e.g.
TRASH.001, TRASH.002, etc).
All dump files are left in the same subdirectories you mail is in. Note that
Eudora places each mail folder in a subdiirectory off the current level.
You may want to PKZIP one or more of the *.DMP files and then move them out of
your Eudora subdirectories, perhaps storing them on a floppy diskette for
purposes of retaining them. As long as you are reasonably sure you will not
want to be doing responses or something in Eudora, you can delete the messages
from the mailboxes you save this way.
Personally, I save all of my outgoing messages for some reason. I then save an
ASCII version of what I sent, compress it, and then delete them en masse.
If you'd like, you can get just the table of contents for the messages and skip
the actual dump of the messages themselves. This can be achieved by using the
/HEADER option.
If you later decide you want to kill off all of the *.DMP files, pass in the
parameter /KILLDUMP and it will take care of them for you.
Specifying parameters:
Parameters for this program can be set in the following ways. The last setting
encountered always wins:
- Read from an *.INI file (see BRUCEINI.DOC file),
- Through the use of an environmental variable (SET EUMAIL=whatever), or
- From the command line (see "Syntax" below)
EUMAIL.DOC 6 Revised: 10-27-96
Syntax:
EUMAIL { /Eeudora_sub | /SCAN [ d: ] } [ /Ooutput_sub ]
[ /NL=filename | /-NL ] [ /REPEAT ]
[ /NS=filename | /-NS ] [ /n ] [ /nK ] [ /n% ] [ /SHOWEXT ] [ /Q ]
[ /DUMP | /HEADERS | /SPLIT | /KILLDUMP ] [ domain ] [ /FORMAT=n ]
[ /HEAD=xxxx ] [ /Tpath ] [ /MONO ] [ /Iinitfile | /-I ] [ /? ]
where:
"/Eeudora_sub" is the location where you installed Eudora. There is no default
for this parameter; /SCAN C: will be invoked if one is not provided and this
can take awhile. The use of a EUMAIL.INI file is heavily recommended to set
this parameter (see BRUCEINI.DOC).
"/SCAN d:" specifies that the program is to search for the Eudora subdirectory.
(It actually looks for the first file named NNDBASE.TXT.) A disk drive can be
specified (e.g. "/SCAN E:"). If none is provided, the program will scan your C:
drive for the file. Searching can take awhile; use of the "/Eeudora_sub"
parameter is recommended.
"/Ooutput_sub" is the subdirectory in which you want to write the two output
files. This subdirectory must exist already. It defaults to /OC:\TEMP. Again,
the use of a EUMAIL.INI file is heavily recommended (see BRUCEINI.DOC).
"/NL=filename" specifies the filename that the nickname listing is to go to. If
no drive/path information is specified, this file will be written to your
/Ooutput_sub specification. Otherwise, the name will override the /Ooutput_sub
specification. Saying "/-NL" or "/NL=" without any filename indicator will
suppress the creation of the nicknames file altogether. Defaults to
/NL=EUMAIL.TXT.
"/-NL" suppresses the creation of the nickname file entirely.
"/REPEAT" says to repeat the names of the nicknames when they're listed. It
looks better if you don't repeat them but if you use something like FIND on the
file, you might want to have them repeating. Initially defaults to /-REPEAT.
"/-REPEAT" is the opposite of "/REPEAT". The name of the nickname only appears
once even if it contains five e-mail addresses. There very first example in
this documentation shows the output with /-REPEAT. This is initially the
default.
"/NS=filename" specifies the filename that the mailbox/folder summary listing is
to go to. If no drive/path information is specified, this file will be written
to your /Ooutput_sub specification. Otherwise, the name will override the
/Ooutput_sub specification. Saying "/-NS" or "/NS=" without any filename
indicator will suppress the listing of the summary altogether. Defaults to
/NS=EUMAIL.BOX.
"/-NS" suppresses the creation of the mailbox summary file entirely.
EUMAIL.DOC 7 Revised: 10-27-96
"/n" specifies that any mailbox with more than "n" entries is to be indicated on
the screen when the program runs. The test for this is done independently of
the tests for the number or entries or the absolute filesize test; any box with
more than /n message or with a filesize bigger than /nK or a share of more than
/n% will be displayed unless /Q is specified. Defaults to /100.
"/nK" specifies that any mailbox with more than "n" thousand (K) bytes is to be
indicated on the screen when the program runs. The test for this is done
independently of the tests for the number or entries or the absolute filesize
test; any box with more than /n message or with a filesize bigger than /nK or a
share of more than /n% will be displayed unless /Q is specified. Defaults to
/100K.
"/n%" specifies that any mailbox with more than "n" percentage (%) of the total
bytes used by all stored mail is to be shown on the screen when the program
runs. The test for this is done independently of the tests for the number or
entries or the absolute filesize test; any box with more than /n message or with
a filesize bigger than /nK or a share of more than /n% will be displayed unless
/Q is specified. Defaults to /5%.
"/SHOWEXT" shows the message dates as they appear in the Eudora displays. At
times, this is confusing since the dates are actually sorted by their internal
date format. In addition, if you've changed external date formats or you have
one setting in Windows and another in DOS, EUMAIL will blow up with an invalid
function error. Thus it's safer to use /SHOWINT which is the initial default.
If you do decide to use this option, be sure to read the "COUNTRY Notes" section
below.
"/SHOWINT" shows the message dates in their real internal date format. This is
initially the default.
"/Q" says that no individual mailboxes are to be indicated on the screen when
the program runs. This ignores any /n, /nK, or /n% settings.
"/DUMP" says to dump the contents of the mailboxes out as plain ASCII text
documents. The program generates one text file for each mailbox. The program
will also add a table of contents in front of each dump for you. The dump files
will be the name of the folder with a *.DMP file extension. Note that the
messages will appear in the order they show up when you view them on the screen
and you may want to re-sort them all first. See the /HEAD=xxxx parameter too.
Defaults to /-DUMP (don't create the dump files).
"/HEADERS" says to write out the message headers only, not the actual messages.
See the /FORMAT=n parameter below. The header files will be the name of the
folder with a *.DMP file extension.
"/SPLIT" takes each messages and dumps it as a individual text file. The files
will be named as the DOS name of the mailbox with numeric extensions beginning
with 001 (e.g. TRASH.001, TRASH.002, etc).
"/KILLDUMP" deletes any *.DMP files it finds. Also deletes any of the
/SPLIT-produced files (e.g. TRASH.001) that it finds. This is used if you
later decide you don't want any of the *.DMP files around or if you've already
moved out the ones you need and you no longer want the rest of them around.
(Note: /KILLDUMP will not delete any *.DMP or *.xxx files for you if you've
deleted the mailbox itself.)
EUMAIL.DOC 8 Revised: 10-27-96
"domain" restricts /DUMP and /HEADERS processing to only those files whose names
begin with a particular character string. As an example, if you just want to
dump the "Out" mailbox, pass in "OUT". Note that this will also dump other
mailboxes whose names begin with "OUT" which may be useful to you. If your
mailbox name includes a space, you can specify this by replacing the space with
an underscore (e.g. "Joke List" can be entered as "JOKE_LIST"). By default,
all mailboxes are dumped if any are.
"/FORMAT=n" specifies what the headers are to look like in a /DUMP or /HEADERS
request. Basically, /FORMAT=1 creates the headers as one line per message, in a
manner similar to the way that Eudora itself displays the headers. /FORMAT=2
expands the header information to being two lines. /FORMAT=3 is similar to
/FORMAT=1 but the author and date/time are dropped. See the discussion on
"Header formats" above for examples of the each type. Initially defaults to
/FORMAT=1.
"/Tpath" specifies where to write the temporary files that the routine needs.
ISAM data bases are used to store and sort the file names. ISAM files cannot be
created reliably on certain types of drives. Examples are "/TC:" and
"/TC:\TEMP". If not specified, the routine writes to the following in sequence:
- the value of any TEMP, then TMP, environmental variable
- C:\TEMP
- C:\
"/HEAD=xxxx" specifies that instead of seeing all of the message headers when
you dump the messages, it only shows specific lines from the header section. You
can use any combination of the following characters:
T = "To:"
F = "From:"
S = "Subject:"
D = "Date:" So "/HEAD=S" will give you just the Subject line. Normally, you'll
get all of the headers.
"/MONO" (or "/-COLOR") does not try to override screen colors. Initially
defaults to "/COLOR".
"/COLOR" (or "/-MONO") allows screen colors to be overridden. This is initially
the default.
"/Iinitfile" says to read an initialization file with the file name "initfile".
The file specification *must* contain a period. Initfiles are described in the
BRUCEINI.DOC file. Initially defaults to "/IEUMAIL.INI".
"/INULL" says to skip loading the initialization file.
"/?" or "/HELP" or "HELP" shows you the syntax for the command.
EUMAIL.DOC 9 Revised: 10-27-96
Return codes:
EUMAIL returns the following ERRORLEVEL codes:
0 = no problems
250 = operation aborted by pressing Escape
252 = internal restriction breached
253 = no files found
254 = could not find a decent temporary output subdirectory
255 = syntax problems, or /? requested
COUNTRY Notes:
If your DOS COUNTRY setting (which, if not present, defaults to the US date
format of mm-dd-yyyy) is different from the setting you have in Windows (which
is how the dates are showing up in Eudora), you may get "illegal function
call" errors.
The following section tells you how to modify the settings. It's modified
slightly but is copied from the DOS 6.2 HELP command.
The basic format for the COUNTRY command is:
COUNTRY=xxx[,[yyy][,[drive:][path]filename]]
where:
xxx = the country code (see below)
yyy = the character set for the country (used for setting keyboard
types; we'll ignore this one)
[drive:][path]filename = where the COUNTRY.SYS file is
For example:
COUNTRY=033,,c:\dos\country.sys
Says to use France's country code for date, skips the character set
entirely, and says COUNTRY.SYS is c:\dos\country.sys
Changing default settings:
MS-DOS uses the United States as the default setting. You can use the COUNTRY
command in your CONFIG.SYS file to change the setting.
If you do not specify the location and name of the file containing
country-specific information, MS-DOS tries to find the COUNTRY.SYS file in the
root directory of your startup drive.
EUMAIL.DOC 10 Revised: 10-27-96
Specifying supported languages:
The following table lists each country or language supported by MS-DOS. The
table also lists the character sets you can use with each country code. For
example, if you use country code 003, you can use only character set 437 or
850 for the yyy parameter. The first of the two character sets listed for
each country or language is its default character set.
Country or language Country Character sets
code
Belgium 032 850, 437
Brazil 055 850, 437
Canadian-French 002 863, 850
Croatia 038 852, 850
Czech Republic 042 852, 850
Denmark 045 850, 865
Finland 358 850, 437
France 033 850, 437
Germany 049 850, 437
Hungary 036 852, 850
International English 061 437, 850
Italy 039 850, 437
Latin America 003 850, 437
Netherlands 031 850, 437
Norway 047 850, 865
Poland 048 852, 850
Portugal 351 850, 860
Serbia/Yugoslavia 038 852, 850
Slovakia 042 852, 850
Slovenia 038 852, 850
Spain 034 850, 437
Sweden 046 437, 850
Switzerland 041 850, 437
United Kingdom 044 437, 850
United States 001 437, 850
Character sets for the following countries or languages are also available
with special versions of MS-DOS: Arabic, Israel, Japan, Korea, People's
Republic of China, and Taiwan.
EUMAIL.DOC 11 Revised: 10-27-96
Specifying international time and date formats:
The country code specifies the time and date formats used by the following
MS-DOS commands: BACKUP, DATE, RESTORE, and TIME.
The following table lists the date and time formats related to each country
code. For each country code, the "Date format" column shows how MS-DOS
displays January 3, 1993, and the "Time format" column shows how MS-DOS
displays 5:35 P.M. (with 0 seconds and 0 hundredths of a second).
Country or language Country Date code Time format
Belgium 032 23/01/1993 17:35:00
Brazil 055 23/01/1993 17:35:00
Canadian-French 002 1993-01-23 17:35:00
Czechoslovakia 042 1993-01-23 17:35:00
Denmark 045 23-01-1993 17.35.00
Finland 358 23.01.1993 17.35.00
France 033 23.01.1993 17:35:00
Germany 049 23.01.1993 17:35:00
Hungary 036 1993-01-23 17:35:00
International English 061 23-01-1993 5:35:00.00p
Italy 039 23/01/1993 17.35.00
Latin America 003 23/01/1993 5:35:00.00p
Netherlands 031 23-01-1993 17:35:00
Norway 047 23.01.1993 17:35:00
Poland 048 1993-01-23 17:35:00
Portugal 351 23-01-1993 17:35:00
Spain 034 23/01/1993 17:35:00
Sweden 046 1993-01-23 17.35.00
Switzerland 041 23.01.1993 17,35,00
United Kingdom 044 23/01/1993 17:35:00.00
United States 001 01-23-1993 5:35:00.00p
Yugoslavia 038 1993-01-23 17:35:00
Character sets for the following countries or languages are also available
with special versions of MS-DOS: Arabic, Israel, Japan, Korea, People's
Republic of China, and Taiwan.
EUMAIL.DOC 12 Revised: 10-27-96
Author:
This program was written by Bruce Guthrie of Wayne Software. It is free for use
and redistribution provided relevant documentation is kept with the program, no
changes are made to the program or documentation, and it is not bundled with
commercial programs or charged for separately. People who need to bundle it in
for-sale packages must pay a $50 registration fee to "Wayne Software" at the
following address.
Additional information about this and other Wayne Software programs can be found
in the file BRUCEymm.DOC which should be included in the original ZIP file.
("ymm" is replaced by the last digit of the year and the two digit month of the
release. BRUCE603.DOC came out in March 1996. This same naming convention is
used in naming the ZIP file that this program was included in.) Comments and
suggestions can also be sent to:
Bruce Guthrie
Wayne Software
113 Sheffield St.
Silver Spring, MD 20910
fax: (301) 588-8986
e-mail: bguthrie@nmaa.org
http://hjs.geol.uib.no/guthrie/
See BRUCEymm.DOC file for revision history.
Please provide an Internet e-mail address on all correspondence.